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I . Email Template 


JIOWA 


Email Template 
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I . Email Template 


JIOWA 


Plain text enriched with 
template notation elements 
which are enclosed by 
« ... » 


Automatic value ft ropagation which is explained in this presentation, is a feature of 
the template engine of the JIOWA Code Generation Framework! 

If you are not familiar with the framework you should check the tutorial here: 

Slides and quick introduction: www.jiowa.de/products/#jiowa-codegen 


Template file: Letter, jgt 

Dear «Salutation --> Mr: {Mr.} I Mrs: {Mrs.}» «Name», 

we hereby want to inform you... 
bla bla bla . 

Best regards, 

«ContactPerson» 
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I . Email Template (2) 


JIOWA 


Template file: Letter, jgt 


TemplateBean Class: Letter_jgt 


Dear «Salutation --> 


▼ © Letterjgt 

Mr: {Mr.} 1 Mrs: {Mrs.}» «Name», 


► 0 s Salutation 



o f Salutation : Salutation 

we hereby want to inform you... 

A 

• c LetterJgtO 

r 

bla bla bla . 

Jm 

• LetterJgt(TemplateBean) 



• getContactPerson() : String 



• getNameO : String 

Best regards, 

1 

• ^id() : String 



• setContactPerson(String) : Letterjgt 

«ContactPerson» 


• setName(String) : Letterjgt 


Using the template bean in your program: 

Letter_jgt template = new Letter_jgt(); 

template . Salutation . set_Mr() ; 
template . setName("Smith" ) 

. setContactPerson(" Jenny Jones") ; 

System . out . println(template) ; 






Dear Mr. Smith, 

we hereby want to inform you... 
bla bla bla . 

Best regards, 

Jenny Jones 


How can we write email templates for different languages 

but insert the data only once? The solution is on the next slide! 


© 20 1 2-20 1 6 by JIOWA Business Solutions GmbH - www.jiowa.de 


5 


2. Multilingual Templates 


JIOWA 


Multilingual 

Templates 
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JIOWA 

2. Multilingual Templates 


What if we have multiple templates with the same logical 
structure but just different visual appearence? 


Template file: GermanLetter . jgt 


Sehr «Salutation --> Mr: {geehrter Herr} 1 

i 

Mrs: {geehrte Frau}» «Name», 

i 

wir mdchten Sie hiermit darauf hinweisen... 

Automatic } 

bla bla bla . . . 

Build 

Mit freundlichen GriiGen 


«ContactPerson» 



' © GermanLetterJgt 
► © 8 Salutation 

o F Salutation : Salutation 

• c GermanLetterJgtO 

• c GermanLetterJgt(TemplateBean) 

• getContactPersonO : String 

• getNameO : String 

• A id() : String 

• setContactPerson(String) : GermanLetterJgt 

• setName(String) : GermanLetterJgt 


Template file: FrenchLetter . jgt 

«Salutation --> Mr: {Cher Monsieur} I 

Mrs: {Chere Madame}» «Name», 

nous aimerions vous signaler... 
bla bla bla. . . 

Avec nous meilleurs sentiments, 

«ContactPerson» 



I FrenchLetterJgt 
► 0 s Salutation 

o F Salutation : Salutation 

• c FrenchLetterJgtO 

• c FrenchLetter Jgt(TemplateBean) 

• getContactPersonO : String 

• getNameO : String 

• ^id() : String 

• setContactPerson(String) : FrenchLetterJgt 

• sctName(String) : FrenchLetterJgt 
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JIOWA 

2. Multilingual Templates (2) 


What if we have multiple templates with the same logical 
structure but just different visual appearance? 

Using letter templates in different languages at the same time: 


Letter_jgt letter = new Letter_jgt() ; 
letter . Salutation . set_Mr() ; 

letter .setNameC Bean' ).setContactPerson("Mary Moneypenny' ); 

// two examples for automatic value propagation 
// via 'parent constructor' initialization: 

GermanLetter_jgt brief = new GermanLetter_jgt(letter) ; 
FrenchLetter_jgt lettre = new FrenchLetter_jgt(letter) ; 


System. out . println(letter); 
System. out . println(brief) ; 
System. out . println(lettre); 


This is called automatic value pmpaggtion ! 


Sehr geehrter Flerr Bean, 

wir mochten Sie hiermit darauf 
hinweisen. . . 
bla bla bla . 

Mit freundlichen GrulSen 

Mary Moneypenny 

Cher Monsieur Bean, 

nous aimerions vous signaler... 
bla bla bla . 

Avec nous meilleurs sentiments, 
Mary Moneypenny 
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JIOWA 


2. Multilingual Templates (3) 


Why does this value propagation work? 

Template file: GermanLetter . jgt 


Same names for inline 
subtemplates and variables! 

i 


Sehr «Salutation --> Mr: {geehrter Herr} 1 

Mrs: {geehrte Frau}» «Name», 

i 

wir mochten Sie hiermit darauf hinweisen... 
bla bla bla . . . 

Automatic 

Mit freundlichen GriiGen 

BujJd 

«ContactPerson» 


Template file: FrenchLetter . jgt 


▼ 0 GermanLetterJgt 
► © s Salutation 

o F Salutation : Salutation 

• c GermanLetterJgtO 

• c GermanLetterJgt(TemplateBean) 

• getContactPersonO : String 

• getNameO : String 

• A id() : String 

• setContactPerson(String) : GermanLetterJgt 

• setName(String) : GermanLetterJgt 


«Salutation --> Mr: {Cher Monsieur} I 

Mrs: {Chere Madame}» «Name», 

nous aimerions vous signaler... 
bla bla bla. . . 

Avec nous meilleurs sentiments, 

«ContactPerson» 



* FrenchLetterJgt 
► © £ Salutation 

o F Salutation : Salutation 

• c FrenchLetterJgtO 

• c FrenchLetterJgt(TemplateBean) 

• getContactPersonO : String 

• getNameO : String 

• A id() : String 

• setContactPerson(String) : FrenchLetterJgt 

• setName(String) : FrenchLetterJgt 
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2. Multilingual Templates (4) 


JIOWA 


Properties of the value propagation mechanism: 

■ If the value of a variable (like «Name» or «ContactPerson») 

in the child template bean is null, the value of the parent template 
bean is taken. 

■ If the value of a variable in a template bean is never initialized, an 
error is logged during code generation. 

■ If the list of sub template beans (like Mr, Mrs) of a sub structure 
(like Salutation) is null, the list of the parent template bean is used 
instead. 

■ Unlike variables, sub structures are optional elements. 

If no sub template beans have been set or added, no text will be 
created for this sub structure. 
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3. Java Class Template 


Java Class 
Template 


3. Java Class Template 


JIOWA 


Template file: Class, jgt 

I 1 

package «PackageName»; 

public class «ClassName» 

{ 

« foreachAttribute --> Attribute. jgt /» 

« Include <-- Constructor .jgt /» 

« foreachAttribute --> Getter. jgt /» 

// {{ProtectedRegionStart : :ManuallyWrittenCode}} 

// ... 

// insert your customized code here! 

// ... 

// {{ProtectedRegionEnd}} 

} 


Java Class Template with 
Includes and Sub Templates 

Includes & sub templates can be 
used to significantly reduce the 
visual complexity of templates! 


© 20 1 2-20 1 6 by JIOWA Business Solutions GmbH - www.jiowa.de 


12 


3. Java Class Template (2) 


JIOWA 


Template file: class . jgt Java Class Template with 



3. Java Class Template (3) 


JIOWA 


Template file: Constructor . jgt 



/** 

* Constructor with all attributes. 

*/ 

public «ClassName»(«foreachAttribute --> Argument. jgt /,») 

{ 

« foreachAttribute — > Attributelnit. jgt /» 

} | 

/, text operator deletes the last comma 
which remains after the last argument 

Template file: Argument . jgt 

« < — AttributeDeclaration. jgt », 1 

Template file: AttributeDeclaration. jgt 

include template 

«DataType» «AttributeName» | 


AttributeDeclaration . jgt 


Template file: Attributelnit . jgt 

this.«AttributeName» = «AttributeName»; 
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JIOWA 

3. Java Class Template (4) 


Template file: Class, jgt 


package «PackageName»; 

public class «ClassName» 

{ 

« foreachAttribute --> Attribute. jgt /» 

« Include <-- Constructor .jgt /» 

« foreachAttribute --> Getter. jgt /» 

// {{ProtectedRegionStart : :ManuallyWrittenCode}} 
// ... 

// insert your customized code here! 

// ... 

// {{ProtectedRegionEnd}} 

} 


Template Bean: Class_jgt 




Automatic Build 



0 Class. jgt 

• c Class.jgtO 

• c Class.jgt(TemplateBean) 

• A id() : String 

• getPackageNameO : String 

• setPackageName(String) : Class.jgt 

• getClassNameO : String 

• setClassName(String) : Class.jgt 

o F foreachAttribute : foreachAttribute 
▼ 0 s foreachAttribute 

• getAIIO : Temp ateBeanList 

• setAII(TemplateBeanList) : Class.jgt 

• setSubTemplate(String) : TemplateBean 

• setSubTemplate(String, TemplateBean) TemplateBean 
9 clear() : void 

• prepend(Argument.jgt) : Class.jgt 

• prepend.Argument.jgtO : Argument.jgt 

• prepend.Argument.jgt(TemplateBean) : Argument.jgt 

• append(Argument.jgt) : Class.jgt 

• append.Argument.jgtO Argument.jgt 

9 append.Argument.jgt(TemplateBean) : Argumentjgt 

• set(Argument.jgt) : Class.jgt 

• set.Argument.jgtO : Argument.jgt 

• set_Argument_jgt(TemplateBean) : Argument_jgt 

• prepend(Attribute.jgt) : Class.jgt 

9 prepend.Attribute.jgtO : Attribute.jgt 

• prepend.Attribute.jgt(TemplateBean) Attribute.jgt 

• append(Attribute.jgt) : Class.jgt 

9 append.Attribute.jgtO : Attribute.jgt 

• append.Attribute.jgt(TemplateBean) : Attribute.jgt 

• set(Attribute.jgt) : Class.jgt 

• set_Attribute_jgt() : Attribute.jgt 

• set_Attribute_jgt(TemplateBean) : Attribute.jgt 
9 prepend(Attributelnit.jgt) : Class.jgt 

• prepend_Attributelnit_jgt() : Attributelnit_jgt 

• prepend.Attributelnit.jgt(TemplateBean) : Attributelnit.jgt 

• append(Attributelnit.jgt) : Class.jgt 

• append_Attributelnit_jgt() : Attributelnit.jgt 

• append_Attributelnit_jgt(TemplateBean) : Attributelnitjgt 

• set(Attributelnit_jgt) : Class.jgt 

9 set.Attributelnit.jgtO : Attributelnitjgt 

• set_Attributelnit_jgt(TemplateBean) : Attributelnitjgt 

• prepend(GetterJgt) : Class.jgt 

• prepend_Getter_jgt() : Getter.jgt 

• prepend.Getter.jgt(TemplateBean) : Getterjgt 

• append(Getter.jgt) : Class.jgt 
9 append.Getter.jgtO : Getterjgt 

• append.Getter.jgt(TemplateBean) : Getterjgt 

• set(Getter.jgt) : Class.jgt 

• set_Getter_jgt() : Getterjgt 

• set_Getter_jgt(TemplateBean) : Getter.jgt 
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JIOWA 

3. Java Class Template: Code Generator 


Code Generator: 


public void generate() 

{ 

// Class: 

Class_jgt t = new Class_jgt(); 
t . setPackageName("example" ) ; 
t . setClassNameC MyClass") ; 

// Attributes: 

Attribute. jgt attrl = t.foreachAttribute.append_Attribute_jgt().setDataType( Long ) . setAttributeName("number ); 
Attribute. jgt attr2 = t.foreachAttribute.append_Attribute_jgt().setDataTypeC String"). setAttributeName( text ); 

// Constructor arguments: 

t.foreachAttribute.append.Argument.jgt(attrl); // 'parent constructor' for variable values 
t.foreachAttribute.append_Argument_jgt(attr2); // works via automatic value propagation 

// Attribute initializations: 

t.foreachAttribute.append.Attributelnit.jgt(attrl); // 'parent constructor' for variable values 
t. foreachAttribute. append_AttributeInit_jgt(attr2); // is similar to a copy constructor 

// Getter: 

t . foreachAttribute . append.Getter. jgt(attrl) ; 
t . foreachAttribute . append.Getter. jgt(attr2) ; 

updateSourceFileC" java/" + t.getPackageName().replaceC' . ' , '/') + "/" + t .getClassNameO + ".java", t .toStringO); 

} 

We insert the attribute values only once! For all other structures (Argument . jgt, 
Attributelnit. jgt & Getter, jgt) we just use the "parent constructor". 
Values will be propagated automatically! 
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JIOWA 


3. Java Class Template: Output 


Code Generator Output: 


package example; 


public class MyClass 

{ 

protected Long number; 
protected String text; 

/** 

* Constructor with all attributes. 

*/ 

public MyClass(Long number, String text) 

{ 

this. number = number; 
this. text = text; 

} 

/** 

* Returns the value of type Long for attribute number. 

* @return value of number 
*/ 

public Long getNumber() 

{ 

return this. number; 

} 

/** 

* Returns the value of type String for attribute text. 

* @return value of text 
*/ 

public String getText() 

{ 

return this. text; 

} 

// {{ProtectedRegionStart : :ManuallyWrittenCode}} 

// ... 

// insert your customized code here! 

// ... 

// {{ProtectedRegionEnd}} 

} 
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JIOWA 

4. Java Class with Inline Templates 


Java Class with 
Inline Templates 
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JIOWA 

4. Java Class with Inline Templates 


package «PackageName»; 

public class «ClassName» 

{ 

« foreachAttribute --> Attribute: 

{ 

protected «DataType» «AttributeName»; 

} 

/» 


Template file: 
JavaClass . jgt 


/** 

* Constructor with all attributes. 

*/ 

public «ClassName»(«foreachAttribute --> Argument: {«DataType» «AttributeName», } /,») 

{ 

« foreachAttribute --> Attributelnit : 

{ 

this .«AttributeName» = «AttributeName»; 

} 

/» 


« foreachAttribute --> Getter: 

{ 

/** 

* Returns the value of type «DataType» for attribute «AttributeName». 

* @return result value 

*/ 

public «DataType» get«+AttributeName»0 

{ 

return this .«AttributeName»; 

} 

} 

/» 


// {{ProtectedRegionStart : :ManuallyWrittenCode}} 
// ... 

// insert your customized code here! 

// ... 

// {{ProtectedRegionEnd}} 

} 


_ 


TemplateBean Class: 
JavaClass_jgt 



Inline templates 

are represented by 
nested template 
beans within the 


enclosing template 
bean! 



▼ ( 3 JavaClass. jgt 

• c JavaClass.jgtO 

• c JavaClassJgt(TemplateBean) 

• ^ id() : String 

• getPackageNameO : String 

• setPackageName(String) : JavaClass.jgt 

• getClassNameO : String 

• setClassName(String) : JavaClass.jgt 

o F foreachAttribute : foreachAttribute 

▼ 0 s foreachAttribute 

o 

parent : JavaClass_jgt 

© 

c foreachAttribute(JavaClass_jgt) 

© 

parentO : JavaClass.jgt 

► 0 

s Argument 

► 0 

s Attribute 

► 0 

s Attributelnit 

► 0 

s Getter 

© 

getAIIO : TemplateBeanList 

© 

setAII(TemplateBeanList) : JavaClass.jgt 

© 

setSubTemplate(String) : TemplateBean 

© 

setSubTemplate(String, TemplateBean) : TemplateBean 

© 

clear() : void 

© 

prepend(Argument) : JavaClass_jgt 

© 

prepend_Argument() : Argument 

© 

prepend.Argument(TemplateBean) : Argument 

© 

append(Argument) : JavaClass.jgt 

© 

append_Argument() : Argument 

© 

append.Argument(TemplateBean) : Argument 

© 

set(Argument) : JavaClass.jgt 

© 

set_Argument() : Argument 

© 

set.Argument(TemplateBean) : Argument 

© 

prepend(Attribute) : JavaClass.jgt 

© 

prepend.Attributef) : Attribute 

© 

prepend.Attribute(TemplateBean) : Attribute 

© 

append(Attribute) : JavaClass.jgt 

© 

append_Attribute() : Attribute 

© 

append.Attribute(TemplateBean) : Attribute 

© 

set(Attribute) : JavaClass.jgt 

© 

set_Attribute() : Attribute 

© 

set_Attribute(TemplateBean) : Attribute 

© 

prepend(Attributelnit) : JavaClass.jgt 

© 

prepend.Attributelnitf) : Attributelnit 

© 

prepend_Attributelnit(TemplateBean) : Attributelnit 

© 

append(Attributelnit) : JavaClass.jgt 

© 

append.AttributelnitO : Attributelnit 

© 

append.Attributelnit(TemplateBean) : Attributelnit 

© 

set(Attributelnit) : JavaClass.jgt 

© 

set_Attributelnit() : Attributelnit 

© 

set_Attributelnit(TemplateBean) : Attributelnit 

© 

prepend(Getter) : JavaClassJgt 

© 

prepend_Getter() : Getter 

© 

prepend.Getter(TemplateBean) : Getter 

© 

append(Getter) : JavaClass.jgt 

© 

append_Getter() : Getter 

© 

append.Getter(TemplateBean) : Getter 

© 

set(Getter) : JavaClass.jgt 

© 

set_Getter() : Getter 

• 

set_Getter(TemplateBean) : Getter 
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JIOWA 

4. Java Class with Inline Templates: Code Generator 


Code Generator: Value propagation from the previous Java class template! 


public void generate() 

{ 

// Java class with includes and external sub templates 

Class_jgt t = new Class_jgt(); 
t . setPackageNameC'example" ) ; 
t . setClassNameC MyClass") ; 

// Attributes: 

Attribute_jgt attrl = t.foreachAttribute.append_Attribute_jgt().setDataType( Long ) . setAttributeName("number ); 
Attribute_jgt attr2 = t.foreachAttribute.append_Attribute_jgt().setDataType( String") . setAttributeName( text ); 


// further data insertions as before 


// Java class with inline sub templates: 

JavaClass_jgt c = new JavaClass_jgt(t); // 'parent constructor' to get data via value propagation 
c. setPackageNameC'example. inline"); // for complete template structure 

updateSourceFileC" java/" + c.getPackageName().replace(' . ' , '/') + "/" + c.getClassName() + ".java", c ); 

} 
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JIOWA 

4. Java Class with Inline Templates: Output 


Code Generator Output: 


package example. inline; 

public class MyClass 

{ 

protected Long number; 
protected String text; 

/** 

* Constructor with all attributes. 

*/ 

public MyClass(Long number, String text) 

{ 

this. number = number; 
this. text = text; 

} 

/** 

* Returns the value of type Long for attribute number. 

* @return value of number 
*/ 

public Long getNumber() 

{ 

return this. number; 

} 

/** 

* Returns the value of type String for attribute text. 

* @return value of text 
*/ 

public String getText() 

{ 

return this. text; 

} 

// {{ProtectedRegionStart : :ManuallyWrittenCode}} 

// ... 

// insert your customized code here! 

// ... 

// {{ProtectedRegionEnd}} 

} 
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4. Java Class with Inline Templates: 
Data Insertion the other Way around 


JIOWA 


Code Generator: Data insertion the other way around! 


public void generate() 

{ 

JavaClass_jgt c = new JavaClass_jgt(t) ; 
c . setPackageName("example .inline") ; 
c . setClassNameC MyClass") ; 

// Attributes: 

Attribute al = c . foreachAttribute . append_Attribute() . setDataType( 'Long") . setAttributeName( number") ; 
Attribute aZ = c . foreachAttribute . append_Attribute() . setDataType( 'String' ) . setAttributeName( 'text") ; 

// Constructor arguments: 

c.foreachAttribute.append_Argument(al); // 'parent constructor' for variable values 
c.foreachAttribute.append_Argument(aZ); // works via automatic value propagation 

// Attribute initializations: 

c.foreachAttribute.append_AttributeInit(al); // 'parent constructor' for variable values 
c.foreachAttribute.append_AttributeInit(a2); // works via automatic value propagation 

// Getter: 

c.foreachAttribute.append_Getter(al); // 'parent constructor' for variable values 
c. foreachAttribute. append_Getter(a2); // works via automatic value propagation 

updateSourceFileC" java/" + c.getPackageName().replace(' . ' , '/') + "/" + c.getClassName() + ".java", c ); 

// Java class with external sub templates: 

Class_jgt t = new Class_jgt(c); // value propagation the other way around! 
t.setPackageName("example"); // moving this class into another package 

updateSourceFileC" java/" + t.getPackageName().replace(' . ' , '/') + "/" + t .getClassNameQ + ".java", t ); 


The code generator output is identical to the previous slide(s)! 
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JIOWA 

5. Automatic Value Propagation: Summary 


Summary: value propagation for sub templates 

Value propagation for sub templates only takes place if the list in the child 
template bean has not been set, i.e. if it is null. 

For each sub template bean a of the parent bean, an instance of the associated 
sub template bean b of the child bean is created with a as its parent. 

Mapping between sub template beans of different types (but similar names) is 
performed via their name prefix. 

■ An external sub template Attribute, jgt (prefix "Attribute') of the parent 
bean is mapped to another external sub template, like Attribute. cgt, for 
example (where . cgt might have been chosen as suffix for C++ templates). 

If there is no appropriate external sub template it will be mapped to an inline 
sub template (Attribute, for example) with same prefix (if there is one). 

The reverse mapping approach is taken, if the sub template bean to be mapped 
is an inline sub template bean ( first inline, then external). 
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JIOWA 

Automatic Value Propagation in Code Generator Templates 


Questions ? 

Feedback ? 

codegen@jiowa.de 


Java Doc: 

PDF: www.jiowa.de/jiowa-codegen/doc/Jiowa-Value-Propagation-in-Code-Generator-Templates.pdf 


© 20 1 2-20 1 6 by JIOWA Business Solutions GmbH - www.jiowa.de 


24 


